home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / rfntlb10.zip / RFNTLIB.DOC < prev    next >
Text File  |  1994-01-02  |  11KB  |  274 lines
  1. ┌─────────────────────────────────────────────────────────────────────────╖
  2. │                                                                         ║
  3. │                             RFntLib Version 1.0                         ║
  4. │                                                                         ║
  5. │                                                                         ║
  6. │        (c) 1994  Rolf van Gelder, EINDHOVEN - All rights reserved       ║
  7. │                                                                         ║
  8. ╘═════════════════════════════════════════════════════════════════════════╝
  9.  
  10. 1     INTRODUCTION --------------------------------------------------------
  11.  
  12.       RFntLib is a CLIPPER LIBRARY with Screen Font functions.
  13.  
  14.       Parts :
  15.  
  16.       RFntLib.Lib  - Clipper 5.x library with functions to install EGA and VGA
  17.                      screen fonts. The library also contains a couple of
  18.                      INTERNAL (built-in) screen fonts.
  19.  
  20.       RFntS87.Lib  - Clipper Summer '87  version of the library
  21.  
  22.       RFntExo.Lib  - ExoSpace compatible version of the library
  23.                      (for all Clipper versions)
  24.  
  25.       RFntEdit.EXE - Utility program to create / modify EXTERNAL
  26.                      screen font files
  27.  
  28.       RFntKeep.COM - Utility program to install (and keep) a screen font
  29.                      for under MS-DOS
  30.                      (This utility is only available for registered users)
  31.  
  32.       *.RFV, *.RFE - Very many ready-to-use screen font files
  33.  
  34.       RFntLib.NG   - Norton Guide with all the functions in the library
  35.  
  36.       RFntDemo.PRG - Clipper 5.x demo program to illustrate the use of
  37.                      the functions in the library
  38.  
  39.       The functions in RFntLib are very fast because they are entirely
  40.       written in Assembler.
  41.  
  42.       To use RFntLib, a PC with an EGA or VGA adapter is required.
  43.  
  44.       Why RFntLib ?
  45.       - You can use more readable fonts
  46.       - You can create a house style in your applications by using
  47.         your own fonts
  48.       - You can redefine all characters in the character set,
  49.         creating even your own symbols and icons
  50.  
  51.       RFntLib is a Shareware product :
  52.  
  53.       You have the opportunity to try the program at no charge to see if
  54.       it meets your needs.
  55.       If you continue to use the program after evaluation,
  56.       please complete the included registration form (RFntLib.REG, or
  57.       Dutch.REG for Dutch users) and send it with the applicable
  58.       registration fee to the author.
  59.  
  60.  
  61. 2     SCREEN FONT BASICS --------------------------------------------------
  62.  
  63.       RFntLib supports two different types of screen fonts :
  64.          8 x 14 fonts for EGA displays
  65.          8 x 16 fonts for VGA displays
  66.  
  67.       8 x 16 means : 8 dots horizontally; 16 dots vertically
  68.  
  69.       EGA font files can be recognised by the .RFE extension.
  70.       VGA font files have the .RFV extension.
  71.  
  72.       Default, every PC uses a ROM screen font. By using RFntLib
  73.       you can replace this font by a custom font.
  74.       This custom font can be a RFntLib INTERNAL font or a font
  75.       loaded from an EXTERNAL font file.
  76.  
  77.       Technically a screen font consists of 256 characters.
  78.       For an EGA font each character is 14 bytes long;
  79.       for VGA 16 bytes.
  80.       Each byte represents a row (scanline) of 8 dots.
  81.  
  82.       The size of the fonts (and also of the font files) :
  83.          EGA : 256 x 14 = 3584 bytes
  84.          VGA : 256 x 16 = 4096 bytes
  85.  
  86.  
  87. 3     RFntEdit - SCREEN FONT EDITOR ---------------------------------------
  88.  
  89.       RFntEdit is a sophisticated screen font editor that comes with the
  90.       RFntLib package.
  91.       You can use it to create your own fonts or modify the included
  92.       ready-to-use fonts.
  93.  
  94.       The Syntax is :
  95.  
  96.       RFntEdit
  97.  
  98.       In RFntEdit there are 3 screens :
  99.  
  100.       - FONT SELECTION SCREEN
  101.         Features :
  102.         Choose a font file to edit; delete font files; copy font files;
  103.         convert EGA fonts to VGA and vice versa
  104.  
  105.       - CHARACTER SELECTION SCREEN
  106.         Features :
  107.         Choose a character to edit; Save the (modified) font file;
  108.         Print a map to printer or disk;
  109.         (A map is an ASCII dump of all the characters in a font)
  110.  
  111.       - CHARACTER EDITING SCREEN
  112.         You can edit the selected character using many supplied tools as
  113.         Mirror; Scroll; Copy from ROM Font; Copy from Character Map;
  114.         and many others
  115.  
  116.       The usage of RFntEdit is simple and self-explanatory.
  117.  
  118.       Some notes :
  119.  
  120.       - If you are editing a EGA (3584-bytes) font on a PC working in
  121.         VGA mode, the lowest 2 scanlines of the characters are undefined
  122.         and may contain "garbage".
  123.         To prevent this you may switch to EGA-mode before running RFntEdit.
  124.  
  125.       - If you want to copy characters from one font to another, you can
  126.         use the "Clipboard" functions.
  127.         Press <F3> in the Character Editing Screen to copy the current
  128.         character to the clipboard.
  129.         Close the current font and open the target font.
  130.         Edit the target character and press <F4> to paste the character
  131.         from the clipboard
  132.  
  133.       - In the un-registered version of RFntEdit it is not possible
  134.         to save a modified font .... (sorry !)
  135.  
  136.       - MAKE SURE THAT RFNTKEEP IS NOT LOADED WHILE USING RFNTEDIT.
  137.         RFNTKEEP OVERRULES THE FONTS SET BY RFNTEDIT !
  138.  
  139.  
  140. 4     RFntKeep - UTILITY TO LOAD A SCREEN FONT UNDER DOS ------------------
  141.  
  142.       RFntKeep is an utility (for registered users) to load a screen font
  143.       for use under DOS. It's a small TSR program that only consumes about
  144.       4700 bytes.
  145.  
  146.       All font files included with RFntLib (EGA and VGA) can be used with
  147.       RFntKeep. RFntKeep tries to keep the loaded font active, even if an
  148.       application loads a font or switches video mode.
  149.  
  150.       Syntax :   RFntKeep [<FontFileSpec>]
  151.  
  152.       The format of <FontFileSpec> is : [d:][\path\]filename[.ext]
  153.  
  154.       If you omit the font file name the DEFAULT ROM FONT is loaded.
  155.  
  156.       RFntKeep will be loaded in memory only once.
  157.       If already loaded, RFntKeep will change the current font to the
  158.       new <FontFileSpec>.
  159.  
  160.       It is not possible to unload a loaded copy of RFntKeep from memory.
  161.  
  162.       Note :
  163.       MAKE SURE THAT RFNTKEEP IS NOT LOADED WHILE USING RFNTEDIT OR
  164.       RFNTDEMO. RFNTKEEP OVERRULES THE FONTS SET BY RFNTEDIT AND RFNTDEMO !
  165.  
  166.  
  167. 5     RFntLib - CLIPPER LIBRARY -------------------------------------------
  168.  
  169.       RFntLib.Lib contains a number of functions to use different fonts in
  170.       Clipper applications. You can even switch fonts while running the
  171.       application.
  172.       One of the possibilities is to make user-selectable fonts (the user
  173.       can select his own favourite font ...).
  174.  
  175.       RFntLib uses two types of screen fonts :
  176.       - INTERNAL, built-in, fonts (EGA & VGA)
  177.       - EXTERNAL, custom,   fonts from disk (EGA & VGA)
  178.  
  179.       The following functions are available :
  180.  
  181.       * GENERAL *
  182.       R_IsEGAFl () - Determine if an EGA card is present
  183.       R_IsVGAFl () - Determine if an VGA card is present
  184.       R_DefFnt  () - Install default ROM font (EGA or VGA)
  185.       R_FntName () - Retrieve the name of the current font
  186.       R_FntNr   () - Retrieve the number of the current font
  187.  
  188.       * INTERNAL FONTS *
  189.       R_EGAName () - Retrieve the name of an INTERNAL (built-in) EGA font
  190.       R_EGAFnt  () - Install one of the INTERNAL (built-in) EGA fonts
  191.       R_VGAName () - Retrieve the name of an INTERNAL (built-in) VGA font
  192.       R_VGAFnt  () - Install one of the INTERNAL (built-in) VGA fonts
  193.       R_MaxFnt  () - Determine number of INTERNAL (built-in) fonts
  194.  
  195.       * EXTERNAL FONTS *
  196.       R_FntFile () - Install an external EGA or VGA font from a disk file
  197.       R_FntStr  () - Install an external EGA or VGA font from a string
  198.  
  199.       A detailed description of the functions can be found in the
  200.       Norton Guide.
  201.  
  202.  
  203. 6     REGISTRATION --------------------------------------------------------
  204.  
  205.       RFntLib is a Shareware product. It i